home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / gfx / show / agmsfilm2.lha / AGMSMakeFilm.doc < prev    next >
Text File  |  1993-01-05  |  6KB  |  140 lines
  1. AGMSMakeFilm combines picture and sound data files into a cartoon data file
  2. that can be shown with AGMSPlayFilm.  See AGMSFilm.doc for details about
  3. file format and other things.
  4.  
  5. Here are the command line options:
  6.  
  7.  
  8. From/...
  9.  
  10. The list of input files.  You can use ARP wildcards, the files from each
  11. wildcard will be used in alphabetical order.  For example, "from *.snd
  12. happy*.pic old.film" will result in all .snd files in alphabetical order
  13. followed by the selected .pic files in alphabetical order followed by the
  14. old.film file.  The "from" keyword seems to be required to avoid confusing
  15. the command line parser.
  16.  
  17. What kind of input files do you need?  IFF pictures and sounds, with at
  18. least one picture and one sound.  The film will use all the pictures and as
  19. much sound as fits.  The sounds can be in mono or stereo, mono ones will
  20. appear in both left and right channels in the film's stereo sound track.
  21. The sound files must be in uncompressed format (most currently are).  Note
  22. that the output of AGMSMakeFilm is also an IFF file containing pictures and
  23. sound.  You can use an old film as an input file, possibly listing new sound
  24. files before the old film so that they come before the old sound track.
  25.  
  26. Also, the pictures should have the same palette (the palette and screen
  27. modes / size of the first picture will be used to display all of them).
  28. This is useful for cropping existing images - just specify a smaller picture
  29. for the first one in the film and the remaining ones will be cropped to fit
  30. it.  Unlike ANIM5 cartoons, you should not repeat the first two frames at
  31. the end.  Put in all the frames of the cartoon in the order you want them,
  32. just like a real piece of film.
  33.  
  34. One last glitch: things can get very slow when dealing with multi-megabyte
  35. IFF files.  This seems to be a problem with AmigaDOS file writing
  36. operations.  If you notice that AGMSMakeFilm is getting ridiculously slow,
  37. use the "Addbuffers dh0: 1000" command.  That will consume about 550K of
  38. memory and give you better performance.  Repeat if needed.
  39.  
  40.  
  41. To/A
  42.  
  43. This is the required file name for the output file.  The file can be very
  44. large, so make sure your file system has enough space.
  45.  
  46.  
  47. SecondsPerFrame=Secs/K
  48.  
  49. The default for this optional parameter is 0.1 seconds per frame.  To
  50. specify a value, you need to type something like "secs 0.25" on the command
  51. line.  Every picture you specify in the input will be displayed for this
  52. many seconds when the film is shown.  This is of course 1 divided by the
  53. number of frames per second; 15 frames per second corresponds to a "secs"
  54. value of 0.066667.  It doesn't have to be a multiple or factor of the video
  55. display rate and is independant of PAL and NTSC modes (the audio hardware
  56. controls the overall timing of the film).
  57.  
  58.  
  59. ImageFileBuffer=IB/K
  60.  
  61. Size of the buffer that will be used to speed up reading your IFF image
  62. files.  The default is 65536 bytes.  If you want extra performance, make it
  63. as large as your largest input picture.  If you are short of memory, you can
  64. make it smaller.
  65.  
  66.  
  67. AudioFileBuffer=AB/K
  68.  
  69. The size of the buffer that will be used to speed up reading your IFF audio
  70. files.  If your sound files are stereo, two buffers of this size will be
  71. used.  The default size is 32768.  A good size is enough for one second of
  72. sound.
  73.  
  74.  
  75. FilmFileBuffer=FB/K
  76.  
  77. The size of the buffer for the film output file.  Make this one as large as
  78. possible, the default is 1048576 bytes.  Every time it fills up, one
  79. AmigaDOS Write function call is done.
  80.  
  81. One of the limitations of the Amiga's FastFileSystem (2.04) is that it is
  82. slow when writing at the end of a multimegabyte file.  It seems to have to
  83. examine all the disk sectors that keep an index of the data sectors when it
  84. does a Write at the end of the file.  Nope, no seeking involved, just a
  85. simple Write.  With megabytes of data, there are quite a few index sectors
  86. (hundreds if not thousands) so that Write can generate quite a bit of disk
  87. activity beyond that needed for the writing of the actual data.
  88. Fortunately, the AmigaDOS AddBuffers command can be used to cache those
  89. index sectors in memory.  So, try something like "AddBuffers DH0: 1000" if
  90. performance is slow.
  91.  
  92. Between the large buffer size and the AddBuffers, you should be able to get
  93. good performance, at the expense of megabytes of memory.  You do have one of
  94. those 64 megabyte RAM boards?  :-)
  95.  
  96.  
  97. Verbose/S,MegaVerbose/S,UltraMegaVerbose/S
  98.  
  99. Various verbosity control switches.  The default is no verbosity.  Other
  100. settings are useful if you want to see the internal structure of IFF files,
  101. particularly UltraMegaVerbose which will describe palette values and display
  102. modes for pictures and audio parameters for sounds in your input files.  I
  103. recommend the "Verbose" setting.
  104.  
  105.  
  106. QuickScan=QS/S
  107.  
  108. Use this option if you want the first scan of files to stop as soon as the
  109. first audio and video data are encountered.  The advantage is speed.  The
  110. disadvantage is that any sounds after the last sound scanned are ignored.
  111.  
  112. In other words, use this option only if you put all your sound files before
  113. your picture files or if you only have one sound file.  Don't use it if you
  114. are using an old film file as an input - it will stop scanning at the first
  115. frame in the old film, so your sound track will only include the sound from
  116. the first frame and not the rest of the old film.
  117.  
  118.  
  119. Control-C
  120.  
  121. Type a control-C or use the CLI command "Break" to abort the program.
  122.  
  123.  
  124. Distribution
  125.  
  126. AGMSMakeFilm is FreeWare.  Copyright (c) 1993 by Alexander G. M. Smith.
  127. That means that you can use it freely, can't blame me for anything that goes
  128. wrong (there are definitely a few bugs left), and you shouldn't expect more
  129. from it than you paid for it.  Also, don't blame me if your computer runs
  130. out of memory when you use the buffer settings I recommend :-).
  131.  
  132.  
  133. Bugs
  134.  
  135. Let me know if you find any.  My E-mail addresses are in the program credits
  136. (use "?" as the command line argument and then a second "?" at the prompt to
  137. see the credits).  I've found a sporadic memory trashing bug, but it seems
  138. to have gone into hiding after I'd rewritten the disk buffering.  It shows
  139. up as the program trying to open a file with no name.
  140.